Skip to main content

Fetch Virtual Account by ID

Get details of your created virtual account by its ID

GET https://api.spotflow.co/api/v1/virtual-account/:id

Headers

authorization
String

Bearer SECRET_KEY
Include your secret key in the request header as a Bearer token for authorization. Unauthorized requests will result in a 401 HTTP status code.

Path Parameters

id int32

This is the unique ID generated upon creation of your virtual account.

Sample Response:

200 OK

{
"id": "123e4567-e89b-12d3-a456-426614174000",
"accountNumber": "1234567890",
"accountName": "John Doe",
"bankName": "Access Bank",
"type": "INDIVIDUAL",
"mode": "live",
"createdAt": "2025-05-19T10:15:30Z",
"updatedAt": "2025-05-19T10:15:30Z",
"lifecycle": "temporary",
"amount": 900,
"reference": "001",
"expiresAt": "2025-05-19T10:45:30Z"
}